IMailUser : IMAPIProp

The IMailUser interface is implemented by messaging user objects. IMailUser inherits from the IMAPIPropHP08HX interface and has no unique methods of its own. The IMailUser interface provides access to the many properties that are associated with messaging users.

Quick Info

Header file:

MAPIDEFS.H

Exposed by:

Messaging user objects

Implemented by:

Address book providers

Called by:

Client applications

Corresponding pointer type:

LPMAILUSER

 

Vtable Order

No unique methods

Required properties

Access

PR_ADDRTYPE7C7E4S

Read/write

PR_DISPLAY_NAME1KS30YA

Read/write

PR_DISPLAY_TYPEYIXSE1

Read-only

PR_EMAIL_ADDRESSJ.C5HA

Read/write

PR_ENTRYID2JH9H8T

Read-only

PR_OBJECT_TYPE4YLDI0

Read-only

PR_RECORD_KEYQV4J.N

Read-only

PR_SEARCH_KEY_7GFC6

Read-only

 

Five of these required properties are known as the base address properties for recipients: PR_ADDRTYPE, PR_DISPLAY_NAME, PR_EMAIL_ADDRESS, PR_ENTRYID, and PR_SEARCH_KEY. These properties are considered special because many other groups of similar properties are built upon this base group. The other groups are used to describe a recipient in various roles, such as a message s original or delegate sender. For more information about these properties and how to use them, see Address TypesFN0QFN.

Messaging users can display a collection of their properties by supporting the PR_DETAILS_TABLE2Y56ZRM property. PR_DETAILS_TABLE is a display table that describes the layout of a details dialog box   a tabbed property page dedicated to showing recipient property information. Details dialog boxes are created by MAPI when a client calls the IAddrBook::Details1PH5_L2 method.

Messaging user objects can have other optional properties associated with them. MAPI defines over forty properties that provide additional addressing information about a messaging user. All of these properties are character strings. The more commonly used properties are:

PR_ACCOUNT1P0GB23

PR_ASSISTANT10H8.C

PR_BUSINESS_TELEPHONE_NUMBERCL3OMI

PR_GIVEN_NAME15YJ.5C

PR_GOVERNMENT_ID_NUMBER26QZ_H_

PR_LOCALITY12JOLPO

PR_POSTAL_ADDRESS29SGFTE

 

For a complete list of these properties, see User Personal Information PropertiesS0ELWU.